COMMENT ⊗   VALID 00002 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	\input basic
C00026 ENDMK
C⊗;
\input basic
\font X=cmr6 \def \sm{\:X}
\font Y=cmr9 \def\mc{\:Y} % medium caps for names like PASCAL
\font Z=manfnt 
\def\_{\hskip.06em\vbox{\hrule width.3em}} % underline in identifiers
\def\META{{\:Z METAFONT}}
\def\PASCAL{{\mc PASCAL}}
\def\SAIL{{\mc SAIL}}
\def\TUG{{\mc TUG}}
\def\WEB{{\mc WEB}}
\def\DVI{{\mc WEB}}
\def\TFM{{\mc TFM}}
\def\PXL{{\mc PXL}}
\def\TANGLE{{\mc TANGLE}}
\def\WEAVE{{\mc WEAVE}}
\def\DVITYP{{\mc DVITYP}}
\def\POOLTY{{\mc POOLTY}}
\def\TFTOPL{{\mc TFTOPL}}
\def\PLTOTF{{\mc PLTOTF}}
\def\PAS{{\mc PAS}}
    \def\TEX{\hbox{T\hskip-.125em\lower.5ex\hbox{E}\hskip-.075em X}}
\magnify{1200}
\ctrline{\TEX82 Installation Notes}

The following notes are more in the nature of an introduction to the
mystique of installing \TEX82 on your computer than a detailed exposition.
You will need to know a great deal more than can be contained in this
hand-out but at least this should get you started in the right direction.
For more information you should get the hard-copy documentation available
as noted below and perhaps you should join the \TEX\ Users Group by
writing this organization (with check for $\$$20), c/o American
Mathematical Society, P.O. Box 1571, Annex Station, Providence, RI 02901,
and keep up-to-date by reading the newsletter \TUG boat.

The \TEX82 system requires: 1) the \TEX82 program itself, 2) a suitable
supply of font files, both as PXL files containing pixel information in a
form acceptable to your printer and with a compatable set of so-called TFM
files that contain the font metrics only and in a compressed form as used
by \TEX82 itself, \ 3) a device driver program that translates the DVI
output from \TEX\ into the specific form required by your printer, and 4)
a suitable printer that will produce the characters that are specified by
\TEX\ and position them on the page as directed. The so-called
`intelligence' features that are supplied by some printers are not needed
and should not be used.  If you are buying a new printer that has this
feature, make sure that it can be rendered inoperative and that the printer
can be operated in a `slave' mode.

To install \TEX82 you may either 1) obtain the original source programs
for \TEX82 (written in \WEB) and the \WEB\ system from The Computer
Science Department at Stanford University or from a supplier who
reproduces our original tapes and then you must first install the \WEB\
system on your computer, then write a change file for \TEX82, and then
pre-compile \TEX82.\WEB\ using the \WEB\ pre-compiler \TANGLE, all this
before you will be able to get the \TEX82 program into a compilable form,
or 2) obtain your \TEX82 program from some \TEX\ user who has gone through
this process for a similar computer and who can supply you with either a
\PASCAL\ version of \TEX82 or, better yet, with an already-compiled
version.

If you intend to follow the first course, you will have to go through a
rather involved procedure of bootstrapping to get
the \TANGLE\ pre-compiler into operation on
your computer.  The second procedure is by far the easier one to use but
you are then dependent upon this same source for all subsequent updates.
Certain individuals have agreed to act as `site coordinators' for the more
commonly used computers and these people can assist you in locating an
appropiate source.  Names of the appropiate `site coordinator' can be seen in
the most recent issue of \TUG boat.
Some users follow both courses, getting a pre-adapted
version for immediate use and the original source files to insure future
independence.

As mentioned above, \TEX82 is written in a new language called \WEB.  The
\TEX82 source file contains all of the information needed both to produce
a valid \PASCAL\ program and to document the program. There are two
pre-compilers in the \WEB\ system.  One of these, called \TANGLE, accepts
the \TEX82 source file written in \WEB\ and a second, locally produced,
`change' file and produces a valid \PASCAL\ program
which may then be compiled with a \PASCAL\ compiler.  The second
pre-compiler, called \WEAVE, accepts this same source file (together with
the `change' file) and produces another file that
serves as a source for \TEX\ itself and that will then produce a
well-formatted hard-copy document containing both explanatory information
and the \PASCAL\ code, properly indented, using bold-face, italics, etc.,
complete with a table of contents, an index, and with extensive cross
indexing.


The \WEB\ system is, itself, written in \WEB.  The tapes supplied by
Stanford also contain a copy of the \TANGLE\ pre-compiler in PASCAL\ for
use while bootstrapping the \WEB\ system onto your computer. This \PASCAL\ code
will probably not handle input and output in the way desired by your
computer system and so some hand tuning will be required.  Once \TANGLE\ is
up on your system, the system-dependent corrections for \WEB\ source files
obtained from others (including \TEX82 and the \WEB\ pre-compilers
themselves) should always be handled by writing `change files' and
not by modifying the \WEB-written source files.

To reiterate, \TANGLE\ and WEAVE\ each accept two input files, an original
\WEB\ source file and a `change' file that has been written to adapt the
master source file to the particular computer and operating system that
will be used. The format for these change files is explained in the
\WEB\ system documentation.  Change files, once written for any particular
master source file, should be usable with future updates of the master
file with little or no fixing.

Getting an appropriate device driver may be somewhat of a problem since: \ 
1) the driver must be written in a language that is available on your
computer, 2) the driver must take account of the system dependent features
of your particular computer and its operating system, and 3) the driver
must be designed specifically for the particular printer that you will be
using.  Some printer manufacturers are not as obliging as one might
expect and it is sometimes hard to get information as to the exact way in
which the internal circuitry of the printer must be addressed, but this
situation is changing.  If you are buying a new printer be sure that you
get this information before you close the deal.

\ \TEX82 tapes, as supplied by The Computer Science Department at
Stanford and as duplicated by the below listed service, contain among others:
 1) a special `characters' file that
displays samples of all standard characters as written on the tape, 2) the
\WEB, \PAS, \TEX, and \DVI\ forms of \TANGLE, 3) the \WEB\ forms of
\WEAVE, \TEX82, \DVITYP, \POOLTY, \TFTOPL, and \PLTOTF, 4) a few
typical `change' files, 5) the {\mc BASIC.TEX} and {\mc WEBHDR.TEX} files,
6) a representative collection of font files in \TFM\ and \PXL\ forms.
and 7) a typical 9700 driver written in C.

The following documents, all by Donald E. Knuth, contain information of interest
and should be obtained at the time that a tape is ordered:

\noindent 1) The \WEB\ System of Structured Documentation
(Fourth preliminary draft, July, 1982: Version 0.97).

\noindent 2) \TEX ware (first preliminary draft, July, 1982)

\noindent 3) \TEX82 (Guinea Pig Edition, July, 1982: Version -0.25)

\vfill
$$\vbox{\halign{#\qquad\qquad\hfill⊗#\hfill\cr
For standard tapes write:⊗For information write or phone:\cr
Maria Code⊗Professor Arthur L. Samuel\cr
Data Processing Services⊗Computer Science Department\cr
1371 Sydney Drive⊗Stanford University\cr
Sunnyvale, CA. 94087⊗Stanford, Calif. 94305\cr
⊗(415)497-3330\cr}}$$

\vfill

\end



characters

;The second file is the command file used to generate the tape
file you are presently reading:
tugtap.cmd

; Next comes the WEB system.  The SUAI change files are samples from Stanford
;  and the VAXVMS one is by P. Mackay at Washington.  Do send us yours!
;  Note that TANGLE.TEX and TANGLE.PAS are included for testing your port of
;  WEAVE and TANGLE.  TANGLE.PAS is also for boot-strapping.
tangle.web
tangle.pas
tangle.TeX
tangle.suai-changes
tangle.vaxvms-changes
weave.web
weave.suai-changes

; Now TeX and its friends:
TeX.web
poolty.web
tftopl.web
pltotf.web
dvityp.web

; The TRIP files are used to test out your port of TeX and friends.
;  Binary mode is used for non-character files--each byte is translated into
;  four characters representing the its decimal value ('   0' thru ' 255').
;  End-of-file is marked with a '  -1'.
trip.TeX
trip.err
trip.pl
trip.tfm binarymode
trip.dvi binarymode

; These are two temporary header files that work with TeX80, so please pardon a
;  few control characters in BASIC.  TeX82 versions will be included next time.
TeXtap <TeX.fonts>basic.TeX
webhdr.TeX

; Here's the Computer Modern font family, both TFM and 1200PXL files.
cmathx.tfm binarymode
cmb10.tfm binarymode
cmb12.tfm binarymode
cmb5.tfm binarymode
cmb6.tfm binarymode
cmb7.tfm binarymode
cmb8.tfm binarymode
cmb9.tfm binarymode
cmbi10.tfm binarymode
cmbs10.tfm binarymode
cmbsy.tfm binarymode
cmbt.tfm binarymode
cmbti.tfm binarymode
cmcsc.tfm binarymode
cmcsc9.tfm binarymode
cmdunh.tfm binarymode
cmff.tfm binarymode
cmfib.tfm binarymode
cmi10.tfm binarymode
cmi5.tfm binarymode
cmi6.tfm binarymode
cmi7.tfm binarymode
cmi8.tfm binarymode
cmi9.tfm binarymode
cmit.tfm binarymode
cmmu10.tfm binarymode
cmmu7.tfm binarymode
cmnew.tfm binarymode
cmnews.tfm binarymode
cmold.tfm binarymode
cmoldi.tfm binarymode
cmr10.tfm binarymode
cmr12.tfm binarymode
cmr18.tfm binarymode
cmr5.tfm binarymode
cmr6.tfm binarymode
cmr7.tfm binarymode
cmr8.tfm binarymode
cmr9.tfm binarymode
cmrt.tfm binarymode
cms10.tfm binarymode
cms7.tfm binarymode
cms8.tfm binarymode
cms9.tfm binarymode
cmsa10.tfm binarymode
cmsc10.tfm binarymode
cmsc9.tfm binarymode
cmss10.tfm binarymode
cmss12.tfm binarymode
cmss8.tfm binarymode
cmss8b.tfm binarymode
cmss9.tfm binarymode
cmss9b.tfm binarymode
cmssb.tfm binarymode
cmsss.tfm binarymode
cmsss8.tfm binarymode
cmsss9.tfm binarymode
cmst.tfm binarymode
cmsy10.tfm binarymode
cmsy5.tfm binarymode
cmsy6.tfm binarymode
cmsy7.tfm binarymode
cmsy8.tfm binarymode
cmsy9.tfm binarymode
cmsyt.tfm binarymode
cmti10.tfm binarymode
cmti12.tfm binarymode
cmti7.tfm binarymode
cmti8.tfm binarymode
cmti9.tfm binarymode
cmtitl.tfm binarymode
cmtt.tfm binarymode
cmtt8.tfm binarymode
cmtt9.tfm binarymode
cmu10.tfm binarymode
cmathx.1200pxl binarymode
cmb10.1200pxl binarymode
cmb12.1200pxl binarymode
cmb5.1200pxl binarymode
cmb6.1200pxl binarymode
cmb7.1200pxl binarymode
cmb8.1200pxl binarymode
cmb9.1200pxl binarymode
cmbi10.1200pxl binarymode
cmbs10.1200pxl binarymode
cmbsy.1200pxl binarymode
cmbt.1200pxl binarymode
cmbti.1200pxl binarymode
cmcsc.1200pxl binarymode
cmcsc9.1200pxl binarymode
cmdunh.1200pxl binarymode
cmff.1200pxl binarymode
cmfib.1200pxl binarymode
cmi10.1200pxl binarymode
cmi5.1200pxl binarymode
cmi6.1200pxl binarymode
cmi7.1200pxl binarymode
cmi8.1200pxl binarymode
cmi9.1200pxl binarymode
cmit.1200pxl binarymode
cmmu10.1200pxl binarymode
cmmu7.1200pxl binarymode
cmnew.1200pxl binarymode
cmnews.1200pxl binarymode
cmold.1200pxl binarymode
cmoldi.1200pxl binarymode
cmr10.1200pxl binarymode
cmr12.1200pxl binarymode
cmr18.1200pxl binarymode
cmr5.1200pxl binarymode
cmr6.1200pxl binarymode
cmr7.1200pxl binarymode
cmr8.1200pxl binarymode
cmr9.1200pxl binarymode
cmrt.1200pxl binarymode
cms10.1200pxl binarymode
cms7.1200pxl binarymode
cms8.1200pxl binarymode
cms9.1200pxl binarymode
cmsa10.1200pxl binarymode
cmsc10.1200pxl binarymode
cmsc9.1200pxl binarymode
cmss10.1200pxl binarymode
cmss12.1200pxl binarymode
cmss8.1200pxl binarymode
cmss8b.1200pxl binarymode
cmss9.1200pxl binarymode
cmss9b.1200pxl binarymode
cmssb.1200pxl binarymode
cmsss.1200pxl binarymode
cmsss8.1200pxl binarymode
cmsss9.1200pxl binarymode
cmst.1200pxl binarymode
cmsy10.1200pxl binarymode
cmsy5.1200pxl binarymode
cmsy6.1200pxl binarymode
cmsy7.1200pxl binarymode
cmsy8.1200pxl binarymode
cmsy9.1200pxl binarymode
cmsyt.1200pxl binarymode
cmti10.1200pxl binarymode
cmti12.1200pxl binarymode
cmti7.1200pxl binarymode
cmti8.1200pxl binarymode
cmti9.1200pxl binarymode
cmtitl.1200pxl binarymode
cmtt.1200pxl binarymode
cmtt8.1200pxl binarymode
cmtt9.1200pxl binarymode
cmu10.1200pxl binarymode

; Here is a 9700 driver written in C from Dan Grim at UDel.  It runs with
;  old DVI files for the nonce.
TeXtap <TeX.9700>D9700.C
TeXtap <TeX.9700>DVI9700.C
TeXtap <TeX.9700>FNT.C
TeXtap <TeX.9700>MAKEDVI
TeXtap <TeX.9700>MAKEFNT
TeXtap <TeX.9700>MKCODE.C
TeXtap <TeX.9700>MKRULE.C
TeXtap <TeX.9700>MKTAPE.C
TeXtap <TeX.9700>SHOWT.C
TeXtap <TeX.9700>T.C
TeXtap <TeX.9700>XT.C

; That's all, folks.